Skip to main content

Visualisierungselement: Tabelle

Symbol:

_visu_img_table.png

Kategorie: Allgemeine Steuerelemente

Das Element visualisiert Daten, die als Array darstellbar sind, in einer Tabelle. Als Datentyp der visualisierenden Variable kommt daher ein ein- oder maximal zweidimensionales Array, ein Array von einem Array, ein Array von Strukturen oder auch ein Array von einem Funktionsbaustein in Frage.

Elementeigenschaften

Sind alle Elementeigenschaften verfügbar?

Nur wenn Sie in der Eigenschaften die Option Advanced oder den Filter Alle Kategorien aktiviert haben, stehen Ihnen alle Eigenschaften zur Verfügung.

Elementname

Beispiel: Data set component 1

Tipp

Durch die Vergabe von eigenen Elementnamen werden die Elemente in der Elementliste schnell gefunden.

Elementtyp

Tabelle

Datenarray

Array, dessen Daten als Tabelle visualisiert werden

Variable (ARRAY), dessen Datentyp die Anzahl der Spalten und Zeilen der Tabelle bestimmt

. Arraytypen
  • Eindimensionales Array: Die Tabelle hat eine Spalte

  • Zweidimensionales Array: Die zweite Dimension bestimmt die Anzahl der Spalten

  • Array von einem Array: Die Anzahl der Arrayelemente des hinteren Arrays bestimmt die Anzahl der Spalten

  • Array einer Struktur: Die Anzahl der Strukturkomponente bestimmt die Anzahl der Spalten

  • Array eines Funktionsbausteins: Die Anzahl der lokalen Variablen bestimmt die Anzahl der Spalten

Beispiel: PLC_PRG.aiTable

Deklaration: aiTable : ARRAY[0..3, 0..4] OF INT := [4(1, 2, 3, 4, 5)];

Tipp

Wenn sich die Deklaration des Arrays geändert hat, kann die Tabelle durch Setzen des Cursors in das Datenarray-Wertefeld und Drücken der Eingabe aktualisiert werden.

Maximaler Array-Index

Obere Indexgrenze für die angezeigte Tabelle. Begrenzt die Anzahl der angezeigten Reihen. Der Index beginnt bei ArrayStart.

  • Variable (Ganzzahliger Datentyp)

    Beispiel : PLC_PRG.iUpperIndexBoundToDisplay

  • Ganzzahliges Literal

    Beispiel: 4 bewirkt 5 in der Tabelle angezeigte Reihen

Tipp

Die Anzahl der Einträge in der Tabelle kann mit der Eigenschaft Maximaler Array-Index dynamisch festgelegt werden. Dies kann erforderlich sein, wenn die Anzahl der Einträge erst zur Laufzeit bestimmt wird.

Der Index beginnt bei ArrayStart und geht bis Maximaler Array-Index.

Spalten

Das Tabelle-Element stellt die Werte einer Variablen in Tabellenansicht dar. Die Arrayelemente oder Komponenten einer Struktur werden in einer Spalte oder einer Zeile angezeigt. Zweidimensionale Arrays oder Arrays einer Struktur werden in mehreren Spalten angezeigt. Die visualisierte Variable wird in der Eigenschaft Datenarray festgelegt. Wenn dort eine Variable zugewiesen ist, kann die Darstellung der Tabellenspalten, in denen die jeweiligen Arrayelemente dargestellt werden, festgelegt werden. Für jede Spalte, die einem Index n zugeordnet ist, ist eine individuelle Konfiguration möglich.

Tabelle 11. Elementeigenschaft Spalten: Spalte [<n>]

Spaltenüberschrift

Standardmäßig wird der Name des Arrays/der Struktur mit dem zur Spalte gehörenden Index/Strukturkomponente als Überschrift genommen. Wenn als Datenarry ein Array eines Funktionsbausteins ausgewählt wurde, wird als Spaltenüberschrift der Name des Arrays mit der zur Spalte gehörenden lokalen Variablen des Funktionsbausteins verwendet.

Die Spaltenbeschriftung kann hier geändert werden, indem ein neuer Titel eingetragen wird.

Breite

Spaltenbreite in Pixel

Bildspalte

standard icon: In der Spalte können Bilder angezeigt werden. Es werden Bilder der globalen Bildersammlung oder von benutzerdefinierten Bildersammlungen verwendet. Dabei stehen in den Zellen der Tabelle die Bild-IDs, wie in der Bildersammlung definiert.

Bildkonfiguration

Füllmodus

  • Zelle ausfüllen:

    Das Bild passt sich an die Größe der Zelle ohne Berücksichtigung des Höhen-Breiten-Verhältnisses an.

  • Zentriert:

    Das Bild wird in der Zelle zentriert und behält seine Proportionen; d.h. das Verhältnis Höhe-Breite bleibt erhalten.

Transparenz

standard icon: Die Farbe, die in Transparenzfarbe angegeben ist, wird transparent dargestellt.

Transparenzfarbe

Diese Farbe ist transparent dargestellt.

Voraussetzung: Die Eigenschaft Transparenz ist aktiviert.

Textausrichtung der Überschrift

. Ausrichtung des Spaltenkopfs:
  • Links

  • Zentriert

  • Rechts

Vorlage verwenden

_cds_icon_option_deactivated.png: Die Arraydaten werden in der Tabelle angezeigt.

_cds_icon_option_activated.png: Die Tabellenzellen erhalten (konfigurierbar pro Spalte) zusätzliche Eigenschaften, nämlich alle die ein Rechteck hat. Damit erhält eine Tabellenzelle den gleichen Funktionsumfang wie ein Rechteck. Die zusätzlichen Eigenschaften werden unter der Eigenschaft Vorlage angezeigt.

Anwendungsfall: Um eine Benutzereingabe (beispielsweise einen Klick in eine Zelle) zu verarbeiten zu können, muss diese Zelle über eine Eingabekonfiguration verfügen. Dies ist möglich, wenn die Option Vorlage verwenden aktiviert ist. Dann steht unter anderem die Eigenschaft Eingabekonfiguration zur Verfügung und dort kann für ein Mausereignis eine Folgeaktion konfiguriert werden.

Beispiel: Wenn ein Nutzer in der laufenden Visualisierung auf die so konfigurierte Zelle klickt, toggelt die boolesche Variable, die der Zelle zugeordnet ist.

Textausrichtung der Überschrift aus der Vorlage

_cds_icon_option_activated.png: Die Spaltenbeschriftung wird mit den Texteigenschaften aus der Vorlage erstellt.

Vorlage

Wenn die Eigenschaft Vorlage verwenden aktiviert ist, ist diese Eigenschaft sichtbar und darunter sind alle Eigenschaften eines Rechtecks verfügbar.

Tipp

Diese Eigenschaften und deren konfigurierbaren Möglichkeiten sind in der Hilfe zum Element Rechteck, abgerundetes Rechteck, Ellipse beschrieben.



Zeilenkopf anzeigen

standard icon: Die Zeilenüberschrift ist sichtbar.

Beispiel: Bei einem Array wird als Zeilenkopf der Index der Arrayelemente angezeigt.

Spaltenkopf anzeigen

standard icon: Die Beschriftung der Spalte ist sichtbar.

Zeilenhöhe

Höhe der Zeilen in Pixel

Breite Zeilenkopf

Breite der Zeilenbeschriftung

Größe des Scrollbars

Größe des Scrollbars in Pixel

Position

Die Position definiert die Lage und Größe des Elements im Fenster der Visualisierung. Sie bezieht sich auf ein kartesisches Koordinatensystem. Der Ursprung liegt in der oberen linken Fensterecke. Die positive horizontale X-Achse verläuft nach rechts. Die positive vertikale Y-Achse verläuft nach unten.

X

X-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Y

Y-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Breite

Angabe in Pixel

Beispiel: 150

Höhe

Angabe in Pixel

Beispiel: 30

Tipp

Die Werte können auch geändert werden, indem Sie im Editor die Symbole _visu_icon_position_element.png an eine andere Stelle ziehen.

Texteigenschaften

Die Eigenschaften erhalten feste Werte für die Texteigenschaften und wirken auf die Texte, die in Texte → Text oderTexte → Tooltip konfiguriert sind.

Horizontale Ausrichtung

Horizontale Ausrichtung des Texts innerhalb des Elements

Vertikale Ausrichtung

Vertikale Ausrichtung des Texts innerhalb des Elements

Textformat

. Definition, wie zu lange Texte dargestellt werden
  • Default: Zu langer Text wird abgeschnitten

  • Zeilenschaltung: Text wird in mehrere Zeilen umgebrochen

  • Auslassungspunkte: Der sichtbare Text endet mit „…“ und zeigt somit an, dass er nicht vollständig ist.

Schriftart

Beispiel: Standard

_cds_icon_three_dots.png: Dialog Schriftart öffnet sich

_cds_icon_arrow_down.png: Auswahlliste mit Stilschriftarten

Farbe Schriftart

Beispiel: Schwarz

_cds_icon_three_dots.png: Dialog Farbe öffnet sich

_cds_icon_arrow_down.png: Auswahlliste mit Stilfarben

Transparenz

Ganze Zahl (Wertebereich von 255 bis 0)

Der Transparenzwert bestimmt die Durchsichtigkeit der zugehörigen Farbe.

255: Farbe ist deckend

0: Farbe ist voll transparent

Anmerkung

Wenn die Farbe eine Stilfarbe ist und bereits einen Transparenzwert enthält, ist diese Eigenschaft schreibgeschützt.

Dynamische Texte

Dynamische Texte sind variabel indizierte Texte einer Textliste. Zur Laufzeit wird der Text ausgegeben, der aktuell in der Variablen indiziert ist.

Textliste

. Name der Textliste
  • Als Variable (STRING)

  • Als fester Stringliteral mit einfachen Anführungszeichen

    Beispiel: 'Errorlist'

_cds_icon_arrow_down.png: Auswahlliste mit den im Projekt verfügbaren Textlisten

Hinweis: Wenn eine Textliste aus dem Projekt an eine Visualisierung in einer Bibliothek übergeben wird, muss ein Punkt vor den Namen der Textliste angehängt werden.

Textindex

. Textlisten-ID, die auf den gewünschten Ausgabetext verweist
  • Als fester String mit der ID in einfachen Anführungszeichen

    Beispiel: '1'

  • Als Variable (STRING), um die Textausgabe dynamisch zu steuern

    Beispiel: strTextID

    Beispiel Zuweisung: PLC_PRG.strTextID := '1';

Tooltipindex

. Textlisten-ID, die auf den gewünschten Ausgabetext verweist
  • Als fester String mit der ID in einfachen Anführungszeichen

    Beispiel: '2'

  • Als Variable (STRING). um die Textausgabe dynamisch zu steuern

    Beispiel: strToolTipID

    Beispiel Zuweisung: PLC_PRG.strToolTipID := '2';

Schriftartvariablen

Die Variablen ermöglichen, die Darstellung der Texte dynamisch zu steuern.

Schriftname

Variable (STRING) für die Schriftart des Texts

Beispiel: PLC_PRG.stFontVar := 'Arial';

Die Auswahl an Schriftarten entspricht der im Standarddialog Schriftart.

Größe

Variable (ganzzahliger Datentyp) für den Schriftgrad in Pixel

Beispiel: PLC_PRG.iFontHeight := 16;

Die Auswahl an Schriftgraden entspricht der im Standarddialog Schriftart.

Flags

Variable (DWORD) für die Flags, die die die Schriftartdarstellung bestimmen

. Flags:
  • 1: Kursiv

  • 2: Fett

  • 4: Unterstrichen

  • 8: Durchgestrichen

Anmerkung

Sie können die Schriftartdarstellungen kombinieren, indem Sie die Codierung der Flags addieren. Zum Beispiel ein fetter und unterstrichener Text: PLC_PRG.dwFontType := 6;

Zeichensatz

Variable (DWORD) für eine Zeichensatznummer für die Schriftart

Die Auswahl an Zeichensatznummern entspricht der Einstellung Skript des Standarddialogs Schriftart.

Farbe

Variable (DWORD) für die Farbe des Texts

Beispiel: PLC_PRG.dwColorFont:= 16#FF000000;

Flags für Textausrichtung

Variable (Ganzzahliger Datentyp) für die Codierung zur Textausrichtung

Beispiel: PLC_PRG.dwTextAlignment.

. Codierung:
  • 0: Oben links

  • 1: Horizontal zentriert

  • 2: Rechts

  • 4: Vertikal zentriert

  • 8: Unten

Anmerkung

Sie können die Textausrichtungen kombinieren, indem Sie die Codierung der Flags addieren. Zum Beispiel ein vertikal und horizontal zentrierter Text: PLC_PRG.dwFontType := 5;

Tipp

Feste Werte für die Darstellung der Texte sind in den Texteigenschaften gesetzt.

Zustandsvariablen

Die Variablen steuern dynamisch das Verhalten des Elements.

Unsichtbarkeit

Variable (BOOL) für das Umschalten der Sichtbarkeit des Elements

TRUE: Das Element ist zur Laufzeit nicht sichtbar.

Beispiel: bIsVisible mit VAR bIsVisible : BOOL := FALSE; END_VAR

Eingaben deaktivieren

Variable (BOOL) für das Umschalten der Bedienbarkeit des Elements

TRUE: Benutzereingaben zur Laufzeit haben keine Auswirkung. Das Element wird deaktiviert angezeigt.

Tipp

Die Eigenschaft Unsichtbarkeit wird von der Funktionalität „Client-Animation“ unterstützt.

Selektion

Selektionsfarbe

Füllfarbe der selektierten Zeile

Selektionsschriftfarbe

Schriftfarbe der selektierten Zeile

Auswahlart

. Auswahl beim Klick auf die Tabellenzelle
  • Keine Auswahl: Keine Auswahl

  • Zellenauswahl: nur die angeklickte Zelle.

  • Zeilenauswahl: Zeile der angeklickten Zelle.

  • Spaltenauswahl: Spalte der angeklickten Zelle.

  • Zeilen- und Spaltenauswahl: Zeile und Spalte der angeklickten Zelle

Rahmen um selektierte Zellen

standard icon: Es wird ein Rahmen um die selektierten Zellen gezeichnet.

Variable für Spaltenauswahl

Variable (INT) für den Arrayindex der Spalte der selektierten Zelle

Im Fall, dass das Daten-Array auf eine Struktur zeigt, werden die Strukturkomponenten beginnend mit 0 indiziert.

Warnung

Dieser Index repräsentiert nur dann die korrekte Position im Array, wenn keine Spalten von der Anzeige in der Tabelle ausgenommen wurden.

Variable für Zeilenauswahl

Variable (INT) für den Arrayindex der Zeile der selektierten Zelle

Variable für Gültigkeit der Spaltenauswahl

Variable (BOOL)

TRUE: Die Variable in Variable für Spaltenauswahl enthält einen gültigen Wert.

Variable für Gültigkeit der Zeilenauswahl

Variable (BOOL).

TRUE: Die Variable in Variable für Zeilenauswahl enthält einen gültigen Wert.

Zentrum

Die Eigenschaften enthalten feste Werte für die Koordinaten des Rotationspunkts. Der Rotationspunkt ist im Editor als Symbol _visu_icon_center_point.png dargestellt und dient als Zentrum für die Rotation und die Skalierung.

Tipp

Die Werte können auch geändert werden, indem Sie im Editor das Symbol _visu_icon_center_point.png an eine andere Stelle ziehen.

X

X-Koordinate des Rotationspunkts

Y

Y-Koordinate des Rotationspunkts

Absolute Bewegung

Den Eigenschaften können IEC-Variablen zugewiesen werden, um die Position des Elements dynamisch zu steuern. Bezugspunkt ist die linke obere Ecke des Elements. Zur Laufzeit wird das Element als Ganzes bewegt.

Bewegung

X

  • Variable (numerischer Datentyp) für die X-Position (in Pixel)

    Beispiel: PLC_PRG.iPos_X

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach rechts.

Y

  • Variable (numerischer Datentyp) für die Y-Position (in Pixel)

    Beispiel: PLC_PRG.iPos_Y

  • Containervariable Container.Height

    Für weitere Informationen siehe: Position und Größe optimal anpassen

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach unten.

Rotation

Variable (numerischer Datentyp) für den Drehwinkel (in Grad)

Beispiel: PLC_PRG.iAngle1

Der Mittelpunkt des Elements rotiert um den Punkt in Zentrum. Dieser Rotationspunkt wird im Editor als Symbol _visu_icon_center_point.png dargestellt.

Zur Laufzeit bleibt die Ausrichtung des Elements in Bezug zum Koordinatensystem der Visualisierung erhalten. Ein Erhöhen des Werts führt zu einer Rechtsdrehung.

_visu_img_prp_rotation.png

Innere Rotation

Variable (numerischer Datentyp) für den Drehwinkel (in Grad)

Beispiel: PLC_PRG.iAngle2

Zur Laufzeit rotiert das Elements entsprechend dem Variablenwert um den Rotationspunkt in Zentrum. Zudem dreht die Ausrichtung des Elements bezüglich des Koordinatensystems der Visualisierung. Ein Erhöhen des Werts im Code bewirkt eine Rechtsdrehung.

Der Rotationspunkt wird im Editor als Symbol _visu_icon_center_point.png dargestellt.

Anmerkung

Wenn in der Eigenschaft Position → Winkel ein statischer Drehwinkel angegeben ist, wird bei der Visualisierungsausführung zum variablen Drehwinkel der statische Drehwinkel addiert (Offset).

_visu_img_prp_inner_rotation.png

Tipp

Sie können die Variablen mit einer Einheitenumrechnung kombinieren.

Tipp

Die Eigenschaften X, Y, Rotation und Innere Rotation werden von der Funktionalität „Client-Animation“ unterstützt.

Animation

Tipp

Diese Eigenschaften sind nur verfügbar, wenn Sie im Visualisierungmanager die Option Client-Animationen und Überlagerung systemeigener Elemente unterstützen aktiviert haben.

Animationsdauer

Vairable für die Dauer in Millisekunden, in der das Element eine Animation ausführt

  • Variable (Ganzzahliger Wert)

    Beispiel: Menu.tContent mit VAR tContent : INT := 500; END_VAR

  • Ganzzahliges Literal

    Beispiel: 500

. Animierbare Eigenschaften:
  • Absolute Bewegung, Bewegung, X, Y

  • Absolute Bewegung, Rotation

  • Absolute Bewegung, Innere Rotation

  • Absolute Bewegung, Äußere Rotation

Die animierte Bewegung wird ausgeführt, wenn mindestens ein Wert einer animierbaren Eigenschaft geändert wird. Die dann ausgeführte Bewegung ist nicht ruckartig, sondern wird reibungslos in der angegebenen Animationsdauer ausgeführt. Das Visualisierungselement fliegt die Sollposition an und rotiert dabei dynamisch. Die Übergänge sind fließend.

In den Vordergrund bringen

Variable (BOOL) für das Stellen des Elements in den Vordergrund

TRUE: Das Visualisierungselement wird zur Laufzeit im Vordergrund dargestellt.

FALSE: Das Visualisierungselement wird zur Laufzeit in der Ebene dargestellt, in der es im Visualisierungseditor eingefügt wurde.

Beispiel: bIsInForeground mit VAR bIsInForeground : BOOL := FALSE; END_VAR

Zugriffsrechte

Anmerkung

Nur verfügbar, wenn eine Benutzerverwaltung für die Visualisierung eingerichtet ist.

Schaltfläche Zugriffsrechte

Öffnet den Dialog Zugriffsrechte. Dort können Sie die Zugriffsrechte für das Element ändern.

. Statusmeldungen:
  • Nicht gesetzt. Alle Rechte: Zugriffsrecht für alle Benutzergruppen: bedienbar

  • Rechte sind vergeben: eingeschränkte Rechte: Mindestens für eine Gruppe ist der Zugriff eingeschränkt